home *** CD-ROM | disk | FTP | other *** search
/ Space & Astronomy / Space and Astronomy (October 1993).iso / mac / VIEWERS / MSDOS / GIFLIB12.ZIP / DOC / GIF2EPSN.DOC < prev    next >
Text File  |  1991-05-13  |  3KB  |  63 lines
  1.             Gif2Epsn
  2.             --------
  3.  
  4. Program to dump images saved as GIF files on Epson type printers.
  5.  
  6.  
  7. Usage:
  8. ------
  9.  
  10. Usage: Gif2Epsn [-q] [-d DitherSize] [-t BWThreshold] [-m Mapping] [-i] [-n]
  11.                         [-p PrinterName] [-h] GifFile
  12.  
  13. If no GifFile is given, Gif2Epsn will try to read stdin for GIF file.
  14.  
  15.  
  16. Memory required:
  17. ----------------
  18.  
  19. Screen.
  20.  
  21.  
  22. Options:
  23. --------
  24.  
  25. 1. [-q] : quite mode. Default off on MSDOS, on on unix. Controls printout
  26.    of running scan lines. Use -q- to turn off.
  27. 2. [-d DitherSize] : Sets size of dithering matrix, where DitherSize can be
  28.    2,3 or 4 only (for 2x2, 3x3 and 4x4 dithering matrices). Default is 2.
  29.    Note image will be displayed in this mode only if Mapping (see -m)
  30.    selected this mode.
  31. 3. [-t BWThreshold] : Sets threshold level for B&W mapping in percent.
  32.    This threshold level is used in the different mappings as selected via -m.
  33.    Default is 19%.
  34. 4. [-m mapping] : Select method to map colors to B&W. Mapping can be:
  35.    0 : Every none background color is considered foreground (white color but
  36.        is drawn as black by printer, unless -i is specified).
  37.    1 : 0.3 * RED + 0.59 * GREEN + 0.11 * YELLOW > BWThreshold is considered
  38.        white color.
  39.    2 : Colors are mapped as in 1, and use dithering of size as defined using
  40.        -d option. BWthreshold is used here as scaler.
  41.    Default is option 0.
  42. 5. [-i] : Invert the image, i.e. black -> white, white -> black.
  43. 6. [-n] : Nicer image. Uses double density feature of Epson printer, to make
  44.       nicer result. This takes more time (and kill your ink cartridge
  45.       faster...) but results are usually better.
  46. 7. [-p PrinterName] : by default output is sent to LPT1:. If  other device
  47.       or disk file is required, they should be specified here. Note
  48.       devices are NOT specifed with colon, so to use LPT2: instead:
  49.       '-p lpt2' is required. Nothing is sent to stdout. If a disk file is
  50.       created: '-p file1.eps' then it can be printed any time by the
  51.       copy command: 'copy file1.eps prn:/b'. Note the /b for binary copy.
  52. 8. [-h] : print one command line help, similar to Usage above.
  53.  
  54. Notes:
  55. ------
  56.   The output has aspect ratio of 1, so square image, will be square in its
  57. hardcopy as well.
  58.   The widest image can be printed is 640 pixels, on 8 inches paper. You
  59. probably will need to flip wider images, if height is less than that:
  60. 'gifflip -r x29.gif | gif2epsn'. Wider images will be clipped.
  61.   This utility dumps output to a file/printer directly. I guess it will have
  62. only a limited usage on unix system...
  63.